home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / lib / mntlib44.zoo / mntlib / getpw.c < prev    next >
Encoding:
C/C++ Source or Header  |  1994-01-16  |  12.5 KB  |  466 lines
  1. /*
  2. Subject:  v08i080:  Public-domain getpw*(3) routines
  3. Newsgroups: mod.sources
  4. Approved: mirror!rs
  5.  
  6. Submitted by: emoryu1!emoryu2!arnold (Arnold D. Robbins)
  7. Mod.sources: Volume 8, Issue 80
  8. Archive-name: getpw
  9.  
  10. Here is public domain re-implementation of the getpwent(3) routines. I have
  11. not included a manual page, since every Unix system has one. I also haven't
  12. even bothered to include a <pwd.h> file; you should be able to use the one
  13. on your system.
  14.  
  15. There is one additional routine:
  16.       setpwfile (file)
  17.       char *file;
  18. which will cause the routines to find password records from a file besides
  19. /etc/passwd.  This is useful should you need to use saved password files,
  20. for instance in doing Unix accounting, where you wish to keep info around on
  21. old accounts, but take the old accounts out of the live password file.
  22. (Can you guess why I just whipped these up?)
  23.  
  24. To switch files, call setpwfile as the very first thing, or call endpwent(),
  25. then setpwfile ("/some/file").
  26.  
  27. Anyway, I hope this is useful to somene out there.
  28. Arnold Robbins
  29. arnold@emoryu1.{CSNET, UUCP, ARPA, BITNET}
  30. */
  31.  
  32. /* minorly customized by ERS for the MiNT library */
  33.  
  34. /****************************************************************/
  35. /* Module name:   getpw.c                                       */
  36. /* Library name:  mintlibs for Atari ST                         */
  37. /* Author:        Hildo Biersma (boender@dutiws.twi.tudelft.nl) */
  38. /* Date:          January 29, 1993                              */
  39. /* Revision:      1 (add password aging, add System V routines, */
  40. /*                   include three man pages, add example code) */
  41. /****************************************************************/
  42.  
  43. /*
  44. NAME
  45.     getpw - get name from UID
  46.  
  47. SYNOPSIS
  48.     #include <pwd.h>
  49.  
  50.     int getpw(int uid, char *buf);
  51.  
  52. DESCRIPTION
  53.     getpw searches the password file for a user id number that
  54.     equals uid, copies the line of the password file in which uid
  55.     was found into the array pointed to by buf, and returns 0.
  56.     getpw returns non-zero if uid cannot be found.
  57.  
  58.     This routine is included only for compatibility with old UN*X
  59.     systems and should not be used in any new programs; see
  60.     getpwent for routines to use instead.
  61.  
  62. FILES
  63.     /etc/passwd
  64.  
  65. SEE ALSO
  66.     getpwent
  67.  
  68. AUTHOR
  69.     Hildo Biersma, with the help of a UN*X System V man page.
  70. */
  71.  
  72. /*
  73. NAME
  74.     getpwent, getpwuid, getpwnam, setpwent, endpwent,
  75.     fgetpwent, setpwfile - get password file entry
  76.  
  77. SYNOPSIS
  78.     #include <stdio.h>  // Only needed for fgetpwent
  79.     #include <pwd.h>
  80.  
  81.     struct passwd *getpwent(void);
  82.  
  83.     struct passwd *getpwuid(int uid);
  84.  
  85.     struct passwd *getpwnam(const char *name);
  86.  
  87.     void setpwent(void);
  88.  
  89.     void endpwent(void);
  90.  
  91.     struct passwd *fgetpwent(FILE *f);
  92.  
  93.     void setpwfile(const char *name);
  94.  
  95. DESCRIPTION
  96.     getpwent, getpwuid and getpwnam each returns a pointer to an
  97.     object containing the broken-out fields of a line in the
  98.     /etc/passwd file.
  99.     Each line in the file contains a "passwd" structure, declared
  100.     in the <pwd.h> header file. For the definition of this structure
  101.     and the meaning of the fields, see the <pwd.h> header file.
  102.  
  103.     getpwent when first called returns a pointer to the first
  104.     passwd structure in the file; thereafter, it returns a pointer
  105.     to the next passwd structure in the file; so successive calls
  106.     can be used to search the entire file.
  107.  
  108.     getpwuid searches from the beginning of the file until a
  109.     numerical user ID is found matching uid is found and returns
  110.     a pointer to the particular structure in which it was found.
  111.     Thus, it cannot be found to search for several users having
  112.     duplicate numerical user IDs.
  113.  
  114.     getpwnam searches from the beginning of the file until a
  115.     login name matching name is found and returns a pointer to
  116.     the particular structure in which it was found.
  117.  
  118.     If an EOF or an error is encountered on reading, getpwent,
  119.     getpwuid and getpwnam return a NULL pointer.
  120.  
  121.     A call to setpwent has the effect of rewinding the password
  122.     file to allow repeated searches.
  123.  
  124.     endpwent may be called to close the password file when
  125.     processing is complete.
  126.  
  127.     fgetpwent returns a pointer to the next passwd structure in
  128.     the stream f, which matches the format of /etc/passwd.
  129.  
  130.     setpwfile will set the password file to be read from by all
  131.     the above routines except fgetpwent.   
  132.  
  133. FILES
  134.     /etc/passwd
  135.  
  136. SEE ALSO
  137.     getlogin, getgrent, putpwent
  138.  
  139. NOTES
  140.     All information is contained in a static area, so it must
  141.     be copied if it is to be saved.
  142.  
  143.     Password aging is supported.
  144.  
  145.     In order not to suffer from possible future changes in the
  146.     format of the passwd file or in the passwd structure,
  147.     these routines should always be used for reading from file,
  148.     while putpwent should always be used for writing to file.
  149.  
  150.     These routines expect the passwd file to be of type text,
  151.     and can therefore read both DOS and UN*X format files.
  152.  
  153. AUTHORS
  154.     Arnold D. Robbins - original version
  155.     Eric Smith        - adapted for the mintlibs
  156.     Hildo Biersma     - included System V routines and password aging
  157. */
  158.  
  159. /*
  160. PASSWORD AGING
  161.  
  162. DESCRIPTION
  163.     Password aging is in effect for a particular user if his
  164.     encrypted password in the password file is followed by a
  165.     comma and a non-null string of characters from the 
  166.     alphabet (., /, 0-9, A-Z, a-z) also used for the encrypted
  167.     password. (Such a string must be introduced in the first
  168.     place by the super-user.)
  169.  
  170.     The first character of the age, M say, denotes the maximum
  171.     number of weeks for which a password is valid. A user who
  172.     attempts to login after his password has expired should be
  173.     forced to supply a new one. The next character, N say,
  174.     denotes the minimum number of weeks which must expire
  175.     before the password may be changed. The remaining characters
  176.     define the week (counted from the beginning of 1970) when
  177.     the password was last changed. (A null string is equivalent
  178.     to zero.) M and N have numerical values in the range 0-63
  179.     that correspond to the 64-character alphabet mentioned
  180.     above (i.e., / = 1 week; z = 63 weeks). If M = N = 0
  181.     (derived from the string . or ..) the user should be forced
  182.     to change his password the next time he logs in (and the
  183.     "age" should disappear from his entry in the password file).
  184.     If N > M (signified, e.g., by the string /.) only the
  185.     super-user should be able to change the password.
  186.  
  187. SEE ALSO
  188.     a64l, getpwent, putpwent
  189.  
  190. NOTE
  191.     The compliance with password aging in MiNT is a joke, since
  192.     users are not forced to login. Also, the current login program
  193.     supplied in init(1) does not support password aging. This may
  194.     change in the future.
  195. */
  196.  
  197. /*
  198.   FIXME:
  199.   - test *thoroughly*
  200.   - write example code for modifying passwd files, include below
  201. */  
  202.     
  203. #include <stdio.h>
  204. #include <pwd.h>
  205. #include <unistd.h>
  206. #include <string.h>
  207. #include <stdlib.h>
  208. #include <types.h>
  209.  
  210. static char *pwdfile = "/etc/passwd"; /* default passwd file */
  211.  
  212. static FILE *fp = NULL;
  213. static struct passwd curentry;    /* static data to return */
  214.  
  215. static int nextent __PROTO((FILE *fp));
  216.  
  217. /* Get name from uid */
  218. int getpw(uid, buf)
  219. int uid;
  220. char *buf;
  221. {
  222.   FILE *pw;
  223.   char line[256]; /* Assume this will always be enough */
  224.   char *ptr;
  225.  
  226.   if ((pw = fopen("/etc/passwd", "rt")) == NULL)
  227.     return(-1); /* Failure: file could not be opened */
  228.  
  229.   line[255] = 0x00;
  230.   while (!feof(pw))
  231.   {
  232.     fgets(line, 255, pw);
  233.     if ((ptr = strchr(line, ':')) != NULL) /* Password field found */
  234.       if ((ptr = strchr(ptr + 1, ':')) != NULL) /* UID field found */
  235.         if (atoi(ptr + 1) == uid)
  236.         {
  237.           strcpy(buf, line);
  238.           return(0); /* Success */
  239.         }
  240.   }
  241.   return(-1); /* Failure */
  242. } /* End of getpw() */
  243.  
  244. /* Set the name of the passwd file */
  245. void setpwfile(cp)
  246. char *cp;
  247. {
  248.   endpwent();
  249.   if (cp != NULL)
  250.     pwdfile = cp;
  251. } /* End of setpwfile() */
  252.  
  253. /* Rewind the passwd file */
  254. void setpwent()
  255. {
  256.   if (fp != NULL)
  257.     rewind(fp);
  258.   else if ((fp = fopen (pwdfile, "rt")) == NULL)
  259.   {
  260. #ifdef VERBOSE
  261.     fprintf (stderr, "setpwent: %s non-existant or unreadable.\n", pwdfile);
  262. #endif
  263.   }
  264. } /* End of setpwent() */
  265.  
  266. /* End passwd file processing */
  267. void endpwent()
  268. {
  269.   if (fp != NULL)
  270.   {
  271.     fclose (fp);
  272.     fp = NULL;
  273.   }
  274. } /* End of endpwent() */
  275.  
  276. /* Get the next passwd entry from the passwd file */
  277. struct passwd *getpwent()
  278. {
  279.   if (fp == NULL)
  280.   {
  281.     setpwent();
  282.     if (fp == NULL)
  283.       return(NULL);
  284.   }
  285.  
  286.   if (nextent(fp) == 0)
  287.     return(NULL);
  288.   else
  289.     return(&curentry);
  290. } /* End of getpwent() */
  291.  
  292. /* Get first passwd entry from file with pw_uid matching uid */
  293. #ifdef __STDC__
  294. struct passwd *getpwuid(uid_t uid)
  295. #else
  296. struct passwd *getpwuid(uid)
  297. uid_t uid;
  298. #endif
  299. {
  300.   setpwent();
  301.   while (nextent(fp) != 0)
  302.     if (curentry.pw_uid == uid)
  303.       return(&curentry);
  304.  
  305.   return(NULL);
  306. } /* End of getpwuid() */
  307.  
  308. /* Get first passwd entry from file with pw_name matching name */
  309. struct passwd *getpwnam(name)
  310. const char *name;
  311. {
  312.   setpwent();
  313.  
  314.   while (nextent(fp) != 0)
  315.     if (strcmp(curentry.pw_name, name) == 0)
  316.       return(&curentry);
  317.  
  318.   return(NULL);
  319. } /* End of getpwnam() */
  320.  
  321. /* Read the next password structure from a given file */
  322. struct passwd *fgetpwent(f)
  323. FILE *f;
  324. {
  325.   if (f == NULL)
  326.     return(NULL); /* Failure */
  327.  
  328.   if (nextent(f) != 0)
  329.     return(&curentry); /* Success */
  330.  
  331.   return(NULL); /* Failure */
  332. } /* End of fgetpwent() */
  333.  
  334. #if defined(atarist) || defined(__SOZOBON__)
  335. static char savbuf[256];  /* BUFSIZ seems bigger than necessary! */
  336. #else
  337. static char savbuf[BUFSIZ];
  338. #endif
  339.  
  340. /* Static function getting next entry from passwd file */    
  341. static int nextent(fp)
  342. FILE *fp;
  343. {
  344.   char *cp;
  345.  
  346.   if (fp == NULL)
  347.   {
  348.     setpwent();
  349.     if (fp == NULL)
  350.       return(0);
  351.   }
  352.  
  353.   while (fgets(savbuf, (int)sizeof(savbuf), fp) != NULL)
  354.   {
  355.     curentry.pw_age = NULL;
  356.  
  357.     for (cp = savbuf; ((*cp != 0x00) && (*cp != ':')); cp++)
  358.       ;
  359.     curentry.pw_name = savbuf;
  360.     *cp++ = 0x00;
  361.     curentry.pw_passwd = cp;
  362.     for (; ((*cp != 0x00) && (*cp != ':')); cp++)
  363.       if ((*cp == ',') && (curentry.pw_age == NULL))
  364.       {
  365.         /* Password age field found */
  366.         *cp++ = 0x00;
  367.         curentry.pw_age = cp;
  368.       }
  369.     *cp++ = 0x00;
  370.     curentry.pw_uid = atoi(cp);
  371.     for (; ((*cp != 0x00) && (*cp != ':')); cp++)
  372.       ;
  373.     *cp++ = 0x00;
  374.     curentry.pw_gid = atoi(cp);
  375.     for (; ((*cp != 0x00) && (*cp != ':')); cp++)
  376.       ;
  377.     *cp++ = 0x00;
  378.     curentry.pw_gecos = cp;
  379.     curentry.pw_comment = cp;
  380.     for (; ((*cp != 0x00) && (*cp != ':')); cp++)
  381.       ;
  382.     *cp++ = 0x00;
  383.     curentry.pw_dir = cp;
  384.     for (; ((*cp != 0x00) && (*cp != ':')); cp++)
  385.       if (*cp == '\\')
  386.     *cp = '/';
  387.     *cp++ = 0x00;
  388.     curentry.pw_shell = cp;
  389.     for (; ((*cp != 0x00) && (*cp != ':') && (*cp != '\n')); cp++)
  390.       if (*cp == '\\')
  391.     *cp = '/';
  392.     *cp = 0x00;
  393.     if (curentry.pw_age == NULL)
  394.       curentry.pw_age = cp; /* Don't return NULL, return a null string */
  395.     return(1);
  396.   }
  397.   return(0);
  398. } /* End of nextent() */
  399.  
  400. /* Old test program removed - Hildo Biersma */
  401. #ifdef EXAMPLE
  402.  
  403. /*
  404. EXAMPLE PROGRAM
  405.  
  406. DESCRIPTION
  407.     Read all lines from the password file and print all users
  408.     with password aging info. Also print a description of
  409.     the meaning of the aging information of this user.
  410.  
  411. AUTHOR
  412.     Hildo Biersma (boender@dutiws.twi.tudelft.nl)
  413.  
  414. STATUS
  415.     Example code; in the public domain.
  416. */
  417.  
  418. #include <support.h>
  419.  
  420. void main()
  421. {
  422.   struct passwd *this_entry;
  423.   int max_age, min_age;
  424.   char *ptr, min[2], max[2];
  425.   time_t time;
  426.   
  427.   min[1] = max[1] = 0x00;
  428.   while ((this_entry = getpwent()) != NULL)
  429.     if ((this_entry->pw_age[0]) != 0x00)
  430.     {
  431.       if ((max[0] = this_entry->pw_age[0]) != 0x00)
  432.       {
  433.         max_age = (int)a64l(max);
  434.         if ((min[0] = this_entry->pw_age[1]) != 0x00)
  435.         {
  436.           min_age = (int)a64l(min);
  437.           ptr = this_entry->pw_age + 2;
  438.           time = a64l(ptr) * (3600L * 24 * 7); /* Seconds per week */
  439.         }
  440.         else
  441.           time = 0L;
  442.       }
  443.       else
  444.       {
  445.         min_age = 0;
  446.         time = 0L;
  447.       }
  448.       fprintf(stdout, "Name: %s, UID: %d.\n", this_entry->pw_name,
  449.               this_entry->pw_uid);
  450.       if ((max_age == 0) && (min_age == 0))
  451.         fprintf(stdout, "User should change password on next login.\n\n");
  452.       else if (min_age > max_age)
  453.         fprintf(stdout, "Only super-user may change password.\n\n");
  454.       else
  455.       {
  456.         fprintf(stdout, "Must change every %d weeks.\n", max_age);
  457.         fprintf(stdout, "May change every %d weeks.\n", min_age);
  458.         fprintf(stdout, "Last changed in week starting %s\n\n",
  459.                 ctime(&time));
  460.       }
  461.     }
  462.     
  463.   endpwent();
  464. } /* End of main() */
  465. #endif /* EXAMPLE */
  466.